package com.micro.ai.auth.service;

import com.micro.ai.auth.dto.UserDTO;
import com.micro.ai.auth.dto.UserRegisterRequest;
import com.micro.ai.auth.dto.UserCreateRequest;
import com.micro.ai.auth.dto.UserUpdateRequest;
import com.micro.ai.auth.dto.PasswordChangeRequest;

/**
 * 用户服务接口
 * 
 * @author micro-ai
 * @since 0.0.1
 */
public interface UserService {

    /**
     * 用户注册（公开接口，需要验证码）
     * 
     * @param request 注册请求
     * @return 用户信息
     */
    UserDTO register(UserRegisterRequest request);

    /**
     * 管理员创建用户（无需验证码，支持设置初始状态）
     * 
     * @param request 创建用户请求
     * @return 用户信息
     */
    UserDTO createUser(UserCreateRequest request);

    /**
     * 获取当前用户信息
     * 
     * @param userId 用户ID
     * @return 用户信息
     */
    UserDTO getCurrentUser(String userId);

    /**
     * 更新用户信息
     * 
     * @param userId 用户ID
     * @param request 更新请求
     * @return 用户信息
     */
    UserDTO updateUser(String userId, UserUpdateRequest request);

    /**
     * 修改密码
     * 
     * @param userId 用户ID
     * @param request 密码修改请求
     * @return 是否成功
     */
    boolean changePassword(String userId, PasswordChangeRequest request);

    /**
     * 重置密码
     * 
     * @param phone 手机号
     * @param smsCode 短信验证码
     * @param newPassword 新密码
     * @return 是否成功
     */
    boolean resetPassword(String phone, String smsCode, String newPassword);

    /**
     * 为用户分配角色
     * 
     * @param userId 用户ID
     * @param roleIds 角色ID列表
     */
    void assignRoles(String userId, java.util.List<String> roleIds);

    /**
     * 移除用户的角色
     * 
     * @param userId 用户ID
     * @param roleIds 角色ID列表
     */
    void removeRoles(String userId, java.util.List<String> roleIds);

    /**
     * 分页查询用户（管理员）
     * 
     * @param pageNum 页码
     * @param pageSize 每页数量
     * @param tenantId 租户ID
     * @param keyword 关键词
     * @param status 状态
     * @return 用户分页列表
     */
    com.baomidou.mybatisplus.extension.plugins.pagination.Page<UserDTO> listUsers(
            int pageNum, int pageSize, String tenantId, String keyword, String status);

    /**
     * 获取用户详情（管理员）
     * 
     * @param userId 用户ID
     * @return 用户信息
     */
    UserDTO getUserById(String userId);

    /**
     * 更新用户状态（管理员）
     * 
     * @param userId 用户ID
     * @param status 状态
     */
    void updateUserStatus(String userId, String status);

    /**
     * 删除用户（管理员）
     * 
     * @param userId 用户ID
     */
    void deleteUser(String userId);
}
